home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 081 / opus2.arc / OCTL_000.ARC / OPUS_CTL.DOC < prev    next >
Encoding:
Text File  |  1986-12-30  |  6.9 KB  |  190 lines
  1.  
  2.                                      OPUS
  3.  
  4.             (c)Copyright 1986; Wynn Wagner III; All rights reserved.
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                 OPUS_CTL: The OPUS-CBCS Control File Compiler
  12.  
  13.                                11 October 1986
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.             "Foolish consistency is the hobgoblin of small minds."
  26.                                         -- Ralph Waldo Emerson
  27.  
  28.  
  29.  
  30. ------------------------------------------------------------------------------
  31.  
  32.  
  33.                                     Upfront
  34.  
  35.          There are no warranties or guarantees of any kind for this
  36.          program or for any other Opus software.  The entire risk of
  37.          using Opus_Ctl and any other Opus software is yours.
  38.  
  39.  
  40.  
  41. ------------------------------------------------------------------------------
  42.  
  43.                               Using The Compiler
  44.  
  45.          Refer to the sample control file, OPUS.CTL, for information
  46.          about the contents and syntax used in control files.  It has
  47.          extensive notes/comments in it.  That information is not
  48.          repeated here.
  49.  
  50.          Opus uses information stored in a PRM ("parameter") file.  That
  51.          file is a "memory image" of some important information.  When you
  52.          start the Opus system, the software will access your disk drive
  53.          only once or twice before it can begin operation.  Using a data
  54.          file, instead of a text control file insures that Opus will be
  55.          up and running in a very short amount of time.
  56.  
  57.          This program, OPUS_CTL, converts a control file from regular
  58.          text into the data file used by Opus.  You create the control
  59.          file using any text editor.  Do *NOT* use a word processor like
  60.          WordStar unless you can be sure that it will produce a regular
  61.          text file with NO word processing codes.
  62.  
  63.          All control files end with CTL when they are in a text format.
  64.          The compiler produces a PRM file using the information in your
  65.          CTL file.
  66.  
  67.          To submit a CTL file to the compiler, type Opus_Ctl followed
  68.          by the name of the control file.
  69.  
  70.  
  71.          EXAMPLES:
  72.  
  73.                   Opus_ctl Opus          Converts OPUS.CTL into OPUS.PRM
  74.  
  75.                   Opus_Ctl Norm          Converts NORM.CTL into NORM.PRM
  76.  
  77.  
  78.  
  79. ------------------------------------------------------------------------------
  80.  
  81.                                      Oops
  82.  
  83. The Control File Compiler tends to be picky about things.  It will be
  84. rough on you to find and eliminate as many problems as possible.  By the
  85. time you get finished, we hops to have a PRM file that won't cause serious
  86. problems for the Opus system itself.
  87.  
  88. Messages tell you where the error occured (line #) and the general
  89. nature of the problem.  The compiler will also print an excerpt of
  90. the offending line.
  91.  
  92. Here is a typical error message from Opus_Ctl:
  93.  
  94.                         Control file error, line #30
  95.                         A path specifier MUST end with `\'        
  96.                                  ***Netinfo  C:\Opus
  97.  
  98.  
  99.  
  100. This is a list of some of the ways Opus_Ctl might complain at you.
  101.  
  102.  
  103. Message                             Meaning/suggested action
  104.  
  105. EXIT/CHAIN/DOS/RUN expected         You used either OUTSIDE or ZERO but
  106.                                     didn't put EXIT, CHAIN, DOS, or RUN
  107.                                     after the command.
  108.  
  109. Name too long                       File/Path names must be shorter
  110.                                     than 65 characters.
  111.  
  112. File not found                      The control file you specified isn't
  113.                                     available.  Spelling counts, you know.
  114.  
  115. Memovfl                             Memory problem.  Opus_Ctl should 
  116.                                     operate in about 128k.
  117.  
  118. A path specifier MUST end with `\'  If you have to specify a path for any
  119.                                     reason, make sure it ends with a
  120.                                     backslash.
  121.  
  122. Not a command or a comment          The line makes no sense at all
  123.  
  124. Unknown privilege level             The privileges are:
  125.                                              TWIT
  126.                                              DISGRACE
  127.                                              NORMAL
  128.                                              PRIVEL  (or PRIVIL)
  129.                                              EXTRA
  130.                                              ASSTSYSOP
  131.                                              SYSOP
  132.  
  133. Date format expected                The date format specifiers are:
  134.                                              yymmdd
  135.                                              mm/dd/yy
  136.                                              mm-dd-yy
  137.                                              dd mmm yy
  138.                                              dd mmm yyyy
  139.  
  140. Number expected                     Opus was expecting a digit.  It probably
  141.                                     found a letter of the alphabet.
  142.  
  143. Invalid baud rate                   A baud rate is a number between 0
  144.                                     and 32700.
  145.  
  146. Unknown file type                   You used FILE or USES, but didn't follow
  147.                                     the command with a recognized file type.
  148.                                     For example, in the line "Uses Logo",
  149.                                     the word LOGO is the file type.  See
  150.                                     the sample Control File for a list of the
  151.                                     file types currently being used.
  152.  
  153. Modem???                            When you use the word MODEM, you need to
  154.                                     follow it with COM1, COM2, or INIT.
  155.  
  156. Illegal new user class              Opus won't let you have new users
  157.                                     logging on as ASSTSYSOP or SYSOP.
  158.  
  159. EXPECTED: `Level',                  If you use the word LOGON, it must be
  160.           `Pre-registered',         followed by LEVEL, PRE-REGISTERED or
  161.            or `Questionaire'        QUESTIONAIRE.
  162.  
  163.  
  164. NOTE: Time limit for TWIT is 199.   If you give any class of user more than
  165.                                     100 minutes per call, Opus_Ctl will
  166.                                     suggest it might be a mistake.
  167.  
  168. Define what?                        The word DEFINE must be followed by
  169.                                     TIME, LOGON LEVEL, LOGON BAUD, or
  170.                                     FILE BAUD.
  171.  
  172. Internal failure                    Contact 124/108 if you see this
  173.  
  174. MEM: Bad Free                       Contact 124/108 if you see this
  175.  
  176.  
  177. ------------------------------------------------------------------------------
  178.  
  179. In addition to the above errors, the compiler will report any problems you
  180. might have with your computer, its disk drives, and/or network.  Those
  181. messages should be self-explanatory....
  182.  
  183. Example...                  Fubar.Ctl: no such file
  184.  
  185.  
  186.  
  187.                                       ###
  188.  
  189.  
  190.